Sourced from asciidoctor-pdf's releases.

v2.3.20

This is a significant patch release in the 2.3.x release line to address compatibility with Ruby 3.3 and Ruby 3.4, fix numerous bugs, and provide some welcomed improvements.

This release suppresses the warning issued by Ruby 3.3 and 3.4 about the use of Ruby's logger gem when loading Asciidoctor. It also fixes a crash when Asciidoctor PDF attempts to preload the bigdecimal gem when using Ruby 3.4.

This release include numerous bug fixes. If the font is missing the NULL character, the converter will ensure no space is allocated for it. If a resolved attribute value in the running content contains an attribute reference (recursive), the converter will not drop that line. If a bordered or shaded block gets carried over to the next column on the first page of a document that uses page columns, the block's extent will be computed correctly. If the link on an image targets an (internal) anchor, that link will resolve properly.

In terms of improvements, the big one is that a horizontal dlist is now rendered without the use of prawn-table, which means the description for an entry may exceed the height of a single page. This release also bundles the glyphs for the shift, command, option and return keys to the fallback font. The font size for sub and sup can now be set independently of one another using an extended converter. The value of the minimum font size keys in the theme accept a relative value (e.g., 0.75em). When generating a print or prepress PDF, the hide-uri-scheme attribute is honored when appending the URL to the link text.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Improvements

• add symbols for shift, command, option, and return keys to the fallback font
• render horizontal dlist without using prawn-table, allowing the description to exceed the height of one page (#2591)
• allow relative font size for sub and sup to be set independently (support combined setting for backwards compatibility)
• allow value of base-font-size-min and <category>-font-size-min theme keys to be relative (e.g., 0.75em) (#2547)
• respect hide-uri-scheme attribute when appending URL to link text when media is print or prepress (#2583)

Bug Fixes

• always force NULL character to have 0 width, even if missing from font (#2585)
• don't drop line in running content if attribute reference resolves to text that contains attribute reference (not originally present)
• correctly calculate extent for block in columns that starts below doctitle (#2579)
• support internal link on image (value of link attribute starts with #) (#2572)

Compliance

• suppress warning about the use of Ruby's logger gem when loading Asciidoctor
• ignore error if bigdecimal gem cannot be eagerly required

Release meta

Released on: 2025-09-16 Released by: @​mojavelinux Release beer: Oktoberfest by Athletic Brewing

Logs: resolved issues | source diff | gem diff

Credits

A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.

• deac395 release 2.3.20
• a01032e fix Asciidoctor Diagram version in release and upstream dispatch workflows [s...
• 61685f0 remove inadvertent CHANGELOG entry [skip ci]
• e32cecd upgrade concurrent-ruby gem to latest release
• 4fc0626 reclassify CHANGELOG entry; mention suppressing logger warning [skip ci]
• 1859cd3 mention change to eager load of bigdecimal gem [skip ci]
• 40fcd61 rewrite border in margins use case
• 8ce428e add use case of adding a border around the whole page (PR #2544)
• b0bb172 revise CHANGELOG entries
• 4422707 backport fix for #2591 render horizontal dlist without using prawn-table
• Additional commits viewable in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)